Skip to main content

DescribeEntityList

Description

No description for this api.

Request Method

POST

Request Path

/apsara/route/Sas/DescribeEntityList

Request Parameters Common Parameters

NameLocationTypeRequiredSample valueDescription
StatusBODYstringNoNo sample value for this parameter.Server Guard Agent status. Value: offiline: offline pause: Pause protection status
RegionNoBODYstringNoNo sample value for this parameter.area number.
AccountBODYstringNoNo sample value for this parameter.filter host instances with abnormal login events. Value: remoteLogin
PageSizeBODYintegerNoNo sample value for this parameter.specifies the maximum number of records per page in the returned result. default value: 20
OSBODYstringNoNo sample value for this parameter.host operating system type, value range: win: indicates Windows type of operating system linux: indicates Linux type operating system
HealthBODYstringNoNo sample value for this parameter.filter host instances with baseline check problems. Value: exception
TagIdListBODYstringNoNo sample value for this parameter.host asset tag ID.
versionBODYstringNo2016-01-01version of api
GroupIdBODYlongNoNo sample value for this parameter.asset group ID.
CurrentPageBODYintegerNoNo sample value for this parameter.specifies the number of pages currently returned. default value: 1
SuspiciousBODYstringNoNo sample value for this parameter.filter host instances with abnormal events. Value: exception
regionIdBODYstringYesNo sample value for this parameter.region id
TrojanBODYstringNoNo sample value for this parameter.filter host instances with backdoor files. Value: webshell: indicates a website trojan file process: indicates Trojan process
PatchBODYstringNoNo sample value for this parameter.filter vulnerable host instances. Value: vul

Return data

NameTypeSample valueDescription
ClientStatusbooleanno demo valuewhether the host instance is protected or not, whether it returns or not indicates that the host is pausing protection.
AegisVersionstringno demo valueServer Guard Agent version.
BuyVersionstringno demo valueServer Knight package version.
RequestIdstringno demo valuerequest ID.
PageSizeintegerno demo valuepage displays the maximum number of records.
OSstringno demo valueoperating system type.
Ipstringno demo valuehost asset IP. description gives priority to the public IP of the host. if the host does not have a public IP, the private IP is displayed.
EntityListarrayno demo valuehost instance list information, see the following parameter description for specific sub-items.
AegisOnlinebooleanno demo valueWhether the Server Guard Agent is online.
Flagintegerno demo valueHost ID: 0: indicates Alibaba Cloud ECS instance 1: indicates non-Alibaba Cloud host
GroupIdintegerno demo valueasset group ID.
InstanceNamestringno demo valuehost instance name.
TotalCountintegerno demo valuereturns the total number of records.
Uuidstringno demo valuehost asset UUID.
CurrentPageintegerno demo valuecurrently returns page number.
nametypeno demo valueDescription
Regionstringno demo valuearea code.

Example

Successful Response example

{
"ClientStatus":"no demo value",
"AegisVersion":"no demo value",
"BuyVersion":"no demo value",
"RequestId":"no demo value",
"PageSize":"no demo value",
"OS":"no demo value",
"Ip":"no demo value",
"EntityList":"no demo value",
"AegisOnline":"no demo value",
"Flag":"no demo value",
"GroupId":"no demo value",
"InstanceName":"no demo value",
"TotalCount":"no demo value",
"Uuid":"no demo value",
"CurrentPage":"no demo value",
"name":"no demo value",
"Region":"no demo value"
}

Failed Response example

{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}

}